v0.15.1

Compare Source

Patch Changes

• f9c4061: fix(blob): Enforce content-type on fetch requests during token generation

  Before this change, we would not send the content-type header on fetch requests sent to your server during client uploads. We consider this a bugfix as it should have been sent before.

  ⚠️ If you upgrade to this version, and you're using any smart request body parser (like Next.js Pages API routes) then: You need to remove any JSON.parse(request.body) at the handleUpload step, as the body will be JSON by default now. This is valid for the onBeforeGenerateToken and onUploadCompleted steps.

v0.15.0

Compare Source

Minor Changes

• d57df99: Adds a new mode: folded | expanded (default) parameter to the list command options. When you pass folded to mode, then we automatically fold all files belonging to the same folder into a single folder entry. This allows you to build file browsers using the Vercel Blob API.

v0.14.1

Compare Source

Patch Changes

• 0e9fc17: Exports the ListBlobResultBlob so it can be imported from the @​vercel/blob package.
• 41c4483: This introduces jsdoc comments for all functions that are publicly accessible in the @​vercel/blob npm package.

v0.14.0

Compare Source

Minor Changes

• 9a6c44f: Add copy method to @​vercel/blob package. This method offers the functionality to copy an existing blob file to a new path inside the blob store. #​419

v0.13.1

Compare Source

Patch Changes

• 15de089: fix(deps): update dependency undici to v5.26.2 [security]

v0.13.0

Compare Source

Minor Changes

• 3cf97b1: This new version brings consistent and detailed errors about request failures (store does not exist, blob does not exist, store is suspended...).
  BREAKING CHANGE: head() will now throw instead of returning null when the blob does not exist.

v0.12.5

Compare Source

Patch Changes

• f033492: Handle relative urls in upload()'s callbackUrl #​399

v0.12.4

Compare Source

Patch Changes

• d90e973: Removed "types" field from package.json to support "moduleResolution": "Node16"

v0.12.3

Compare Source

Patch Changes

• c0fe4e7: vercelBlob.head() now sends a cacheControl property

v0.12.2

Compare Source

Patch Changes

• 15f7eef: Fix types for old module resolution. Before this commit types for the main package would be imported with a dot in the import path on autocompletion.

v0.12.1

Compare Source

Patch Changes

• ae93246: Fix `Cannot find module '@​vercel/blob/client' errors for JavaScript projects or TypeScript projects with an old moduleResolution setting.

v0.12.0

Compare Source

Minor Changes

• 8251462: This release introduces BREAKING CHANGES. Mostly, we've separated client and server needs better. While ensuring we only export what we currently think is useful to you.

  We have a completely new documentation about client (browser) uploads: https://vercel.com/docs/storage/vercel-blob/quickstart#client-uploads.

  We've moved and renamed client-related utilities, including the ones to generate client tokens, to a separate entry file: @vercel/blob/client. Use it this way:

  import {
    upload,
    handleUpload,
    generateClientTokenFromReadWriteToken,
  } from '@​vercel/blob/client';

  Here are the new features:

  • You can now pass a clientPayload?: string option during client uploads via the upload method. This payload can be used to attach metadata to your file, for example when updating a blog post cover image, you may want to pass: clientPayload: JSON.stringify({ postId: 123 }), so you can then use it server side to update the blog post.

  Here are the BREAKING CHANGES:

  • handleBlobUpload has moved to client/handleUpload
  • For client (browser) uploads, please use client/upload instead of put. Also, the handleBlobUploadUrl option has been renamed to handleUploadUrl.
  • verifyCallbackSignature is no more exported if you think you need it, open an issue
  • BlobCommandOptions type is no longer exported. This is an internal utility type. Other internal types were removed also but nobody was using them
  • metadata in onBeforeGenerateToken and onUploadCompleted has been renamed to tokenPayload

  Enjoy!

v0.11.0

Compare Source

Minor Changes

• b409aad: We added two new options on put():

  • addRandomSuffix: boolean: Allows to disable or enable (default) random
    suffixes added to file paths
  • cacheControlMaxAge: number: Allows to configure the browser and edge cache,
    in seconds. Default to one year (browser) and 5 minutes (edge). The edge cache
    is currently always set to a maximum of 5 minutes. But can be lowered to 0

v0.10.0

Compare Source

Minor Changes

• e273673: BREAKING CHANGE: Some methods responses and types have been updated following a
  migration Vercel did to make Vercel Blob more robust and closer to the S3 API.

  Namely:

  • the urls generated by Vercel Blob have moved from:
    public.blob.vercel-storage.com/zyzoioy8txfs14xe/somefile-NoOVGDVcqSPc7VYCUAGnTzLTG2qEM2.txt
    to
    zyzoioy8txfs14xe.blob.vercel-storage.com/somefile-NoOVGDVcqSPc7VYCUAGnTzLTG2qEM2.txt
    This change has been done transparently: all previous blob urls are
    redirected to the new domain.
  • .put() no more sends back size and uploadedAt, use .head() to get this
    information. Refer to the PutBlobResult type.
  • .list() no more sends back contentType and contentDisposition on the
    blobs property. Refer to the ListBlobResult type.
  • .del() doesn't return any value (void). If the file was here prior to
    a del() call, then it's now deleted.
  • BlobResult type has been splitted to PutBlobResult for put() and
    HeadBlobResult for head(). Use them accordingly.

  We've reworked our README to better surface the browser-upload and
  server-upload methods.

v0.9.3

Compare Source

Patch Changes

• 978a817: Added an API version string when activated, related to multi bucket migration, no need to update for now.